home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1993 September / September 93.iso / Archives / Utilities / System / Keyboards / Keyboard / Keyboard Maps / PopChar 2.6.2 cdev / PopChar Docs < prev   
Text File  |  1993-09-21  |  31KB  |  329 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Version 2.6.2, © 1993 by Günther Blaschek
  8.  
  9. PopChar is a control panel (formerly known as a cdev) that enables you to generate every possible character that is available in the current font without having to remember keyboard combinations.
  10.  
  11. Suppose, you are working with your favourite word processor and would like to insert the character “◊” in your document for some reason. Looking it up with Key Caps can become quite cumbersome, especially when the character you're looking for requires pressing a so-called “dead key” (such as option-“n” or option-“u”) first. PopChar simplifies the insertion of unusual characters. To install PopChar, move it into your Control Panels folder (assuming you're running System 7; on earlier systems, move PopChar into the System Folder proper). Then restart your Mac.
  12.  
  13. Once you have PopChar installed, you will see a small square with a “P” in it in the top left corner of the screen (that is, in the menu bar):
  14.  
  15.  
  16.  
  17.  
  18.  
  19. All you have to do to get an unusual character is to move the cursor into the “P” square (which I will subsequently refer to as the “hot spot” and press the mouse button. Do not press any modifier keys, and do not let the mouse button go too early. Depending on the type of your machine and other installed software, it may take seconds before anything happens. Anyway, a menu with all characters available in the current font will pop up eventually. The following screen snapshot shows how this menu will look like when Monaco is the current font:
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28. Simply move the cursor over the character you want and release the mouse button. The character will get inserted in your text as if you had typed the proper key combination on the keyboard.
  29.  
  30. If you need the same character again and again, it will be more efficient to press the appropriate keys. PopChar provides some assistance for such cases by displaying the keyboard equivalents of the current character in the top right corner of the table. 
  31.  
  32. How does PopChars know about the current font? Well, this is the main trick and also a possible source of incompatibility with certain applications. PopChars first looks whether the frontmost window is a dialog with at least one editable text field. If that is the case, PopChar simply uses the font of the current editable text field. Otherwise, PopChar inspects the menu bar by looking for a checked font name. If it finds one, then it is assumed to be the current font. Otherwise, the current font of the frontmost window is used. If there isn't any window, PopChars will display the Chicago font. The procedure described works well in most cases. It will, however, very likely not work as expected when the application doesn't display the current font in any of its menus. Microsoft Excel is an example of such an application.
  33.  
  34. By the way: It doesn't matter whether the fonts are listed in a “regular” or in a hierarchical menu. PopChar looks through all levels of menus.
  35.  
  36.  
  37.  
  38.  
  39. Since PopChar is a Control Panel, you can configure it to match your requirements and your personal taste:
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57. In the “hot spot” area, you can specify where PopChar should look for mouse clicks. PopChar is preconfigured with the very top left corner of the main screen as the hot spot. If you use other utilities that also look for clicks in this corner, you may want to configure PopChar to come up when the mouse is clicked in a different corner of the menu bar. By the way: PopChar does not conflict with OnCue or NowMenus, since PopChar uses a smaller sensitive area in the very corner of the screen. It will not come up when you click directly on the OnCue or NowMenu icon.
  58.  
  59. Note that PopChar is deliberately confined to the main screen (i.e., the screen that contains the menu bar) for configurations with multiple monitors. The hot spot is always located in the menu bar, and the character table will also always be displayed on this screen.
  60.  
  61. As an alternative to hot spots in the corners of the menu bar, PopChar can also be configured such that it places an icon menu next to the help menu in the menu bar. The icon looks like a key with a “P” on it, as shown in the following figure:
  62.  
  63.  
  64.  
  65.  
  66.  
  67. Of course, this option is available only under System 7 or higher.
  68. I recommend using the icon menu instead of hot spots in the corners of the menu bar, as conflicts with other software are less likely to occur in this mode of operation. You may, however, wish to use hot spots when your main screen is rather small and/or the menu bar is already crammed with other iconic menus (such as WindowPicker).
  69. Note: When you switch from the hot spot mode to the icon menu mode, the icon menu will not appear immediately in currently running applications. You may need to quit and re-launch them in order to see the icon menu. In the case of the Finder, you will have to restart in order to see the icon menu in the Finder's menu bar.
  70.  
  71. “show ordinal number” makes PopChar display the ASCII code of the currently selected character in decimal and hexadecimal, as shown in the following figure.
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79. “look for available font size” affects the way in which PopChar selects the font size it uses in the display. See the paragraph on font sizes below for details.
  80.  
  81. The PopChar character chart normally appears on top of the menu bar. This can cause problems with some non-Apple monitors and with certain INITs that draw into the menu bar even when PopChar's character table is shown. An example for that is Møire's clock feature. Checking “leave the menu bar alone” makes PopChar move the character chart below the menu bar, so that such interferences cannot happen any more.
  82.  
  83. If you agree with Bruno Schäffer (in whose opinion the “P” box pollutes the menu bar), you can turn the “P box” at the hot spot off by unchecking the corresponding check box. This is, however, not recommended when you have set the hot spot to the bottom of the menu bar, since you would then probably find it difficult to hit the hot spot.
  84.  
  85. “show icon at startup” makes PopChar display its icon on the bottom of the screen when you (re)boot your Mac.
  86.  
  87. The “preferred font sizes” field is dedicated to “Snuffy” Smith and all others who suffer from bad eyesight. You can specify up to 5 favorite font sizes (separated by spaces) in which PopChar should display the character table. PopChar comes preconfigured with the setting “14 18 12 10”, as shown in the snapshot above. This means that 14 is the preferred size. If the current font is available in this size, PopChar will use it, otherwise it will look for alternate sizes in the order specified in the list. Now, what happens if the current font is not available in any of these sizes? This depends on the setting of the “look for available font size” check box. If the box is checked, PopChar will scan for an available font size. First, it scans the font sizes starting with the preferred size up to 48, and — if that attempt fails — once more from the preferred size down to 10. This procedure should usually find an available font size. If there really is no font size available in the range 10 thru 48 (or if the “look for available font size” check box was clear in the first place), PopChar will finally give up and display the characters in the preferred size, in which case the characters may have a jaggy appearance.
  88.  
  89. Since TrueType fonts are available in virtually any size, PopChar will always use the preferred size if the current font is a TrueType font. This is not the case when PostScript fonts are used with Adobe Type Manager. ATM pretends that only the sizes for which you have a bitmapped font are available.
  90.  
  91. Select your favorite font sizes carefully! Some fonts may not be legible in small sizes, while others can easily fill your screen in bigger sizes, particularly if you have a small monitor. Since big font sizes also take longer to draw, you should use them only if there is a good reason. I suggest a maximum font size of 18 for small monitors and 24 for portrait monitors and larger. 
  92.  
  93. By the way: If the character chart would become too large to fit on the monitor, PopChar successively tries smaller font sizes until all characters can be displayed.
  94.  
  95. Hint: If you want your fonts always displayed in a single particular size, enter only this size in the list and clear the “look for available font size” check box.
  96.  
  97.  
  98.  
  99. When you move the cursor from the character table to the header of the window, the item “More…” appears in the top right corner of the window (where the key combination is normally displayed). If you want to insert more characters in a row, select the “More…” item and release the mouse button:
  100.  
  101.  
  102.  
  103.  
  104.  
  105. The character chart will then briefly disappear and reappear in a larger window with an additional text area and three buttons. The next picture shows how this looks like on a black and white monitor. When your monitor can display at least 16 colors or shades of gray, the display will be much nicer, of course.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117. You can now click several characters in a row and insert all of them by clicking the “OK” button. The characters will appear in the white area above the buttons. Clicking “Cancel” aborts the whole process, as you would expect, and “Clear” removes all characters inserted so far.
  118.  
  119. You can also insert characters by typing them on the keyboard. The following keys have special meanings:
  120.  
  121. Return, Enter:    Same as clicking “OK”. These keys default to “Cancel” when no characters were selected, in which case the “OK” button is disabled.
  122.  
  123. ESC, Clear:    Same as clicking “Cancel”.
  124.  
  125. Delete:    Removes the last displayed character.
  126.  
  127. Please note that the area where the selected characters appear is not editable. I may include this in a future version, but for now, you can only remove the last character or clear the whole string.
  128.  
  129. When the extended window is shown, PopChar cannot be invoked again by clicking the hot corner or pulling it down from the icon menu. When you have the “show ‘P’ at hot spot” option enabled, you will also notice that the icon has been removed from the menu bar.
  130.  
  131. When you invoke PopChar while SoftPC is active, the “More…” item is not available. This has to do with the special trick PopChar performs for SoftPC (see below). This trick only works for a single character, but not for a series of characters.
  132.  
  133.  
  134.  
  135.  
  136. The struggle for ATR compatibility began when I received the first complaints that PopChar did not recognize fonts that appeared in ATR's hierarchical menus. When I figured out that ATR can be disabled temporarily by holding down the shift key, I included a patch that made ATR believe that the shift key was down when the mouse was clicked in PopChar´s hot spot. This workaround worked reasonably well — until System 6.0.7 was released. For some unknown reason, PopChar disabled ATR entirely on machines equipped with System 6.0.7. I desperately tried different things to work around this problem. One day, I removed the patch again and was surprised to find that everything was fine — until one user running System 6.0.5 complained that PopChar was incompatible with ATR…
  137.  
  138. Another month later, I had to discover that this incompatibility had absolutely nothing to do with the version of the System file. I must admit that I still do not know under which circumstances PopChar conflicts with ATR. PopChar version 2.5.2 and newer uses a different strategy for finding the current font. The problem seems to have disappeared, but I cannot guarantee that. There is still a chance that PopChar refuses to find stylistic variations in submenus. In this case, you should hold down the shift key when you click in PopChar's hot spot. Pressing the shift key temporarily disables ATR and flattens the hierachical menus so that PopChar can find the current font. I sincerely hope that you will never need this workaround, but experience shows that one can never be sure…
  139.  
  140. Should you encounter problems with PopChar and ATR, please send me a report with as many details as possible. Your contribution could help me to find a general solution to this problem.
  141.  
  142.  
  143.  
  144.  
  145. Version 1.4 of PopChar was released at about the same time as Apple´s TrueType technology. US users were the first to discover that PopChar did not work with TrueType fonts. I spent many hours to figure out what went wrong and finally discovered that the FMSwapFont toolbox routine produces funny results when called for a TrueType font. Since this routine provides the only way to figure out which characters are available in a given font, I could not find any way to fix this bug (which was not mine). Versions 1.5 and newer of PopChar contain special code that displays all characters with the ordinal numbers 32 through 255 (except 127) in the character chart when a TrueType font is detected. This range can contain so-called “missing characters” which are then displayed as rectangles. This is for example the case with the Symbol font.
  146.  
  147. I have already received some hints how to figure out which characters are actually available in case of a TrueType font. Due to lack of time (I maintain PopChar entirely in my spare time), the current version does not yet deal with TrueType fonts properly. In the meanwhile, you will have to live with this interim solution.
  148.  
  149. TrueType uses a character cache to keep track of already generated characters. It is fast in most cases, because the characters are generated only on demand. When you activate PopChar with a TrueType font, you will find that it takes excessively long to fill the pop-up window with all characters of the current font. For example, it takes almost 10 (=ten!) seconds to display all characters of Times on a Macintosh IIsi. When you watch PopChar filling the window, you will realize that there are considerable pauses when unusual characters (e.g., accented letters) are drawn. This is because these characters have not been requested before and hence are not yet available in the character cache. If you activate PopChar a second time for the same font, the display is much faster (unless the character cache has been cleared again because many other characters in different fonts have been drawn in the meanwhile).
  150.  
  151. You can avoid the above problems altogether by installing the preferred font sizes as bitmapped fonts together with each TrueType font. For example, my System file contains both the TrueType version of Times and the sizes 9, 10, 12, and 14 as bitmapped fonts. The bitmapped characters can be displayed much faster than their TrueType equivalents, and the problems with determining the available characters do not occur any more. Another advantage (which is not related to PopChar) is that characters in small sizes are more readable in the traditional bitmapped fonts than in TrueType fonts.
  152.  
  153.  
  154.  
  155.  
  156. SoftPC – the famous IBM PC emulator by Insignia Solutions – uses key codes rather than character codes to simulate an IBM keyboard. Versions 2.1 and newer of PopChar try to determine whether SoftPC is running by looking at the name of the current application. If the application's name starts with “SoftPC” (e.g., “SoftPC AT”), PopChar will not generate a single keystroke but rather simulate a sequence of Alt+keypad keystrokes. This seems to work in most cases, although I have found that some characters cannot be generated always. If you have problems with direct insertion of certain characters, enable the “show ordinal number” check box and note the decimal number of the desired character. Then hold down the option (aka “Alt”) key and type the number on the keypad.
  157.  
  158.  
  159.  
  160.  
  161. If there were such thing as a “Macintosh incompatibility award”, Microsoft would be the clear winner. During PopChar's lifetime, Microsoft products cost me more headache than anything else. For example, an interim version of PopChar happily coexisted with Adobe Type Reunion in all applications except Microsoft Word.
  162.  
  163. Another problem appears with Microsoft Excel: Excel does not have a Font menu. Whenever you edit a cell, the current application font (typically Geneva) is used for editing even though the cell may be displayed in a different font. For this reason, PopChar always displays Geneva when invoked from within Excel. Please don't ask me to correct this problem; ask Microsoft to include a font menu or to let you edit a cell in its own font.
  164.  
  165. Yet another problem appeared with Microsoft Works. PopChar worked fine with versions earlier than 3.0 of Works. But when Works 3.0 was released, dozens of Microsoft Works users sent desparate reports that PopChar did not work with Works 3.0 any more. Some users even reinstalled an older version of Works because they did not want to live without PopChar (Microsoft folks, do you read this?). To make PopChar compatible with Works 3.0, some essential parts of PopChar had to be rewritten entirely. It took me several sleepless nights to find a feasible workaround for this problem. I sincerely hope that I did not introduce problems with other applications during this process.
  166.  
  167.  
  168.  
  169.  
  170. Nisus seems to use a dirty trick during execution of some macros. It generates pseudo click at the screen location (0,0) — that is, in the top-left corner of the menu bar. When PopChar is configured such that its “hot spot” is in the top-left corner of the menu bar, it will try to display the character chart and thus interferes with the currently executing Nisus macro.  To resolve this conflict, simply use a different “hot spot” or use PopChar's icon menu mode.
  171.  
  172.  
  173.  
  174.  
  175. To install PopChar, simply move it into your System Folder (or the Control Panels folder on Macs running System 7) and restart your Macintosh. When PopChar is installed, it permanently takes up approximately 17kBytes of memory. To temporarily disable PopChar, hold down the mouse button during restart. To permanently remove PopChar, drag it out of your System folder or Control Panels folder.
  176.  
  177.  
  178.  
  179.  
  180. Some users reported a conflict between PopChar and several versions of MacWrite. I also used to use MacWrite together with PopChar, but have never experienced this problem. I have therefore not been able to find the source of this incompatibility.
  181.  
  182. I have also received reports that PopChar does not work with MacDraw Pro. This seems to be the case only when running under a System older than System 7.
  183.  
  184. Some applications use custom keyboard mappings or rely on key codes rather than character codes. An examples for that is the terminal emulator tn3270. PopChar will display the current font in these applications, but an attempt to insert the selected character will not produce the expected result. There is no solution to this problem.
  185.  
  186. There is a conflict between older versions of BeHierarchic and PopChar. If you want to use BeHierarchic together with PopChar, make sure you have version 1.0.5 or higher of BeHierarchic.
  187.  
  188. If PopChar only shows Chicago or Geneva no matter what the current font is, you may having a conflict with WYSIWYG Menus. Try to change the loading order of PopChar and WYSIWYG Menus by renaming one of these control panels.
  189.  
  190.  
  191.  
  192.  
  193. If PopChar fails to find the current font in a particular application, you should provide me with as much information as possible (see also the “Any Problems?” section below). Versions 2.2.1 and higher of PopChar contain extra debugging code that can help me to solve such problems. Hold down the control key (not the cloverleaf key, but the one labeled “ctrl” on extended keyboards) when you invoke PopChar. Whenever you do this, PopChar appends some crucial information to a file named “PopChar Log” in the System Folder. This is a TeachText file that you can look at. Don't bother trying to find the error by yourself, but rather e-mail me a copy of the file or send me a diskette with such a file on it. Please do not send me just a printout of the file, as it may contain special characters that do not appear on paper. I really do need a copy of the file itself that I can inspect.
  194.  
  195.  
  196.  
  197.  
  198. Version 1.0 of PopChar was an INIT. It worked in principle, but had a couple of nasty bugs and inconveniences.
  199.  
  200. Version 1.1 was turned into a Control Panel. The ability to define the hot spot and to suppress the icon display at startup was added.
  201.  
  202. Version 1.2 had two additional features: The first was that PopChar  displayed a nicer pop-up window when invoked on a color monitor or on a monitor with at least 16 shades of gray. The second was the display of the character's ordinal number.
  203.  
  204. Version 1.3 also offered two new features. The “always use available font size” check box was added, and a first attempt was made to make PopChar compatible with Adobe Type Reunion.
  205.  
  206. Version 1.4 corrected some minor bugs and included the “leave menu bar alone” option (which unfortunately introduced a new bug).
  207.  
  208. Version 1.5 corrected the bug in the “leave menu bar alone” option and introduced an ugly special case for compatibility with TrueType (see above).
  209.  
  210. Version 1.6 was made “more compatible” with Adobe Type Reunion under System 6.0.7.
  211.  
  212. Version 1.7 introduced the “big font” option and another workaround for the nasty ATR problem.
  213.  
  214. Version 1.8 included a couple of cosmetic changes. The Control Panel display was redesigned, and color icons were included for System 7.0. This version was never publicly released.
  215.  
  216. Version 1.9 included a new routine for drawing color icons during startup and introduced the “apply ATR patch” option.
  217.  
  218. Version 1.9.1 corrected an error that caused occasional crashes under System 7.0 with both virtual memory and 32-bit addressing enabled.
  219.  
  220. Version 1.9.2 corrected an error that caused the character chart to be displayed incorrectly on systems with multiple monitors.
  221.  
  222. Version 1.10 also displayed the size of the currently displayed font in the pop-up window.
  223.  
  224. Version 2.0 introduced the “P” box in the menu bar and corrected an internal error that might have been the cause of some incompatibilities in earlier versions. The version numbering step from 1.x to 2.0 was made because several users thought that 1.10 were identical with 1.1.
  225.  
  226. Version 2.1 was the result of a change in the display of the characters. Some users complained that they had to wait until all characters were shown before they could select a character. Since the the chart is drawn while a selection is in progress. This is in particular useful when a TrueType font is displayed. Furthermore, an attempt was made to generate the proper Alt+number keystrokes for SoftPC.
  227.  
  228. Version 2.2 introduced the check box for turning the “P” box off.
  229.  
  230. Version 2.2.1 was the result of some internal changes. The menu scanning algorithm was improved, a bug that had to do with the system font was removed, and the ability to generate a log file was included.
  231.  
  232. Version 2.3 provided additional radio buttons in the control panel with which you can move the hot spot to the bottom of the menu bar. Also, the “P” in the menu bar is  drawn in red if you have a color monitor. And – most important – the “More…” feature has been added.
  233.  
  234. Version 2.4 was an internal version that contained a simple workaraound for RagTime (which, unfortunately, did not quite work).
  235.  
  236. Version 2.5 introduced the flexible font size selection and corrected an error that resulted in a crash when the ATR patch was installed. Also, PopChar was made compatible with RagTime.
  237.  
  238. Version 2.5.1 was a bug fix release. Editing the font size string caused occasional crashes, particularly on pre-System-7 Macs. Another attempt was made to fix the ATR incompatibility.
  239.  
  240. Version 2.5.2 corrected an error that caused a crash in Think Pascal and also with certain non-standard menus. Also, PopChar 2.5.2 hilited the menus during its search for a font menu.
  241.  
  242. Version 2.6.1 corrected many incompatibilities and inconveniences. Major internal changes were made to fix the incompatibility with Microsoft Works 3.0. The icon menu mode was introduced. The hiliting of the menus was removed. The frame around the “P” box is not drawn on secondary monitors any longer. The font size is chosen such that the character chart always fits on the main monitor. Up to 255 characters can be inserted in the “More” mode. An incompatibility with MacWrite Pro was resolved. The PopChar settings are kept in a file called “PopChar Preferences” in the Preferences folder (System 7) or the System folder (pre-System 7). The PopChar icon was made more “System-7-ish”. The “ATR patch” was removed. The documentation (which you are reading right now) was converted to TeachText format.
  243.  
  244. Version 2.6.2 corrects two bugs that were introduced in version 2.6.1. First, the startup icon could not be deactivated, and the iconic menu mode did not work in some configurations.
  245.  
  246.  
  247.  
  248.  
  249. Q:    The top left and the top right corner of my screen are already occupied by other utilities. Can I still use PopChar?
  250. A:    Perhaps. First, try to run PopChar in the icon menu mode. If that is not possible, you could try to rename PopChar so that it loads before or after the other utilities. PopChar uses a rather small sensitive area right in the corner of the screen. One of the other utilities might be more tolerant, so that you can use the same corner for different purposes. For example, you can activate OnCue and NowMenus by clicking on its icon and PopChar by clicking in the “P box” in the very corner. It might also help to move the hot spot to the bottom of the menu bar, although this makes it more difficult to quickly access PopChar.
  251.  
  252. Q:    Could PopChar be customized such that it activates by clicking in a bottom corner of the screen?
  253. A:    No. When PopChar recognizes a click in the hot spot, it first passes the original click to the application before displaying the pop-up window. The application must react to the click by updating its menus, which is only possible when the click was in the menu bar. The next best thing I could do was to provide you with a possibility to move the hot spot to the bottom of the menu bar.
  254.  
  255. Q:    Could PopChar be modified such that it displays only those characters which require special key combinations? The window would become much smaller, because the letters and digits would not have to be shown.
  256. A:    PopChar deliberately shows all characters of the present font. Although this might seem too much of a good thing for fonts like Geneva or Times, it is absolutely necessary for fonts like Symbol, Cairo, Mobile, or Zapf Dingbats, as these fonts contain special characters which correspond to letters and digits.
  257.  
  258. Q:    Since I live in Wonderland, my Mac has a keyboard with a different key layout. PopChar suggests wrong keyboard combinations in some cases. Can it be corrected such that the Wonderlandish keyboard is recognized?
  259. A:    PopChar scans the currently active KCHR resource in the System file to determine the proper key combination. This is correct in most cases. There are, however, countries where additional translations are made which are not reflected in the KCHR table. This is, for example, the case in Austria and Germany. I have not yet found a way to determine the correct key combination in all these cases. You will have to live with that (as I have to).
  260.  
  261. Q:    To insert a character from the Symbol font, I always have to select “Symbol” from the Font menu first. Couldn´t PopChar be modified such that pressing the option key makes PopChar display the Symbol font and insert the selected character in this font?
  262. A:    This is possible in principle, but would require PopChar to feed the application with a sequence of “user” input: a) menu selection of Symbol, b) key press, c) menu selection of the previous font. Faking a menu selection is a fairly complex task, which would make PopChar much bigger with only a little gain of power. Try the following procedure instead:
  263.  — type an “A” instead of the desired special character
  264.  — type whatever is to follow after the special character
  265.  — select the “A”
  266.  — choose “Symbol” (or whatever) from the Font menu
  267.  — use PopChar to replace the “A” with the desired character
  268.  — move the insertion point to where you stopped typing
  269.  — continue typing (in the previous font)
  270.  
  271.  
  272.  
  273.  
  274. PopChar is free, but I reserve all rights to it. This means that you may use it without paying for it, and that you may give it to others without charging for it — nothing more and nothing less. If you like PopChar very much, just send me a picture postcard of your home town with some nice words on it. It is this sort of feedback that keeps me publishing utilities like this one for free. By the way, it would also be great if you could find some unusual stamps. My son collects them all.
  275.  
  276. Bundling PopChar with your product or including it on commercially distributed media requires my explicit consent. Contact me under the address below for details.
  277.  
  278. You are encouraged to upload PopChar on any bulletin board you know of. The only requirements are that PopChar must be distributed in its original form and that this documentation must go along with it. If you have access to a bulletin board and would like to help me to distribute new versions of PopChar, please contact me under one of the e-mail addresses listed below.
  279.  
  280.  
  281. Should you experience any problems with PopChar, PLEASE provide me with as much information as possible. Your report should include
  282. • Macintosh model
  283.    (also: which keyboard type, which monitor, color mode,
  284.     memory configuration, etc.)
  285. • System version
  286. • PopChar version
  287. • What exactly happens when you do what?
  288. • Which other INITs and cdevs do you use? 
  289. • With which other product (which version) is PopChar incompatible?
  290.    Before reporting a problem, you should try different configurations
  291.    and see whether the problem persists. For example, try to
  292.     — use PopChar on another Macintosh or with another System version
  293.     — disable other INITs until you find out which one causes the conflict
  294.     — rename PopChar to load it before or after other INITs. Under
  295.        System 7, also try to move it into the Extensions Folder or into
  296.        the System Folder proper.
  297.  
  298. I will make every reasonable attempt to improve PopChar. However, I cannot promise that I will ever be able to fix your problem (in particular, if I do not have the hardware or software to reproduce your problem) or that I will find the time to do so.
  299.  
  300. Please do not send diskettes, asking me to send you an updated version of PopChar. I don't want any money for PopChar, but neither do I want to spend money for distributing it.
  301.  
  302.  
  303.  
  304.  
  305. Many PopChar users have contributed their ideas and sent me their wish lists. I am obliged to all of them, but in particular I would like to thank
  306. • ALF (alias Alexander Falk), who spent hours on the phone
  307.    during remote debugging sessions.
  308. • Gary Holland and Joe Buccino, who provided the information
  309.    I needed to make PopChar compatible with Adobe Type Reunion.
  310.    Gary also discovered that PopChar couldn't recognize the system
  311.    font in some cases.
  312. • Tony Affigne, who kindly acts as my gateway to CompuServe.
  313. • Andrea Pessino, who found out that PopChar trashed an important
  314.    register and also suggested a fix for this bug.
  315. • Pete Resnick, who provided the code to find the current keyboard layout.
  316. • Those numerous folks (too many to list them all here) who risked life
  317.    and hard disk during testing beta versions of PopChar.
  318.  
  319.  
  320.  
  321.  
  322. If you have any comments, contact me under the following address:
  323.      Günther Blaschek
  324.      Petzoldstr. 31
  325.      A–4020 Linz
  326.      Austria / Europe
  327. or send a message to
  328.      <gue@soft.uni-linz.ac.at>
  329.